Using the Document Editor

As mentioned, the Document Editor is a unique authoring perspective providing an editable design view of a requirements files. The Document Editor toolbar provides standard copy/cut/paste options, basic formatting options, a hide/show rules option, and a document find (search) option. The toolbar is opened when the perspective is opened; it is not available outside the Document Editor as a toolbar option.

In addition to the toolbar, the shortcut menu (available through a right-click) is available to assist in working with elements, attributes, and other authoring tasks in a similar manner as it is used in the Outline Editor. Most of the authoring functionality provided in the Outline Editor is available in the Document Editor. You can modify text, add/remove elements, define attributes, manage rules, and view the document source in both XML and HTML.

All changes made to a document in the Document Editor are saved in the requirements file (the REQ xml) and therefore synchronized immediately in both the Document Editor and Outline Editor perspectives. In fact, when you select an element, or make any changes, in one perspective, the corresponding perspective also updates to select the active element. The author view uses color codes to indicate text sections, element tags, background, as well as to distinquish between parts of the document structure. When you click on a section in the document, the selected section becomes active and the section changes color to indicate it is active, or selected.